home *** CD-ROM | disk | FTP | other *** search
/ Multimedia Jumpstart / Multimedia Microsoft Jumpstart Version 1.1a (Microsoft).BIN / develpmt / drivers / mscdex / testdrv / readme.txt < prev    next >
Encoding:
Text File  |  1992-01-23  |  5.5 KB  |  155 lines
  1.  
  2.  
  3. Final Release Notes for TESTDRV 
  4.  
  5.  
  6. In order to test your driver, you need to do the following:
  7.  
  8. 1. Edit the TESTDRV.PRO file to suit the options for your driver and
  9.     your environment.
  10.  
  11. e.g.
  12. ------------------------------------------------------------------------------
  13.  
  14. ; This is a sample TESTDRV.PRO
  15. ; Comments are started with the ';' and continue to the newline
  16.  
  17. DriverName  = MSCD000   ; the driver to test, same as mscdex
  18. WriteDevice = f         ; the device is not writable
  19. Redbook     = t         ;        Supports redbook addressing
  20. RawMode     = t         ; supports raw mode data
  21. Prefetch    = t         ; supports prefetching
  22. AudioControl  = t       ; supports audio channel manipulation
  23. Audio       = t         ; supports digital audio
  24. AudioChannels = 2       ; 2 audio channels
  25. Interleave  = f         ; does not support interleaving
  26. Eject       = t         ; supports software eject/close
  27. UPC         = t         ; supports UPCcode information calls
  28. SubInfo     = f         ; does not support SubChannel information 
  29. ;Interleaveskip = 0     
  30. ;Interleavesize = 0
  31. ;HSGSectors = 000f00, 0003f3, 00800
  32. ;RedSectors = 4:4:5, 4:2:1
  33. ;OUTPUT         = script.hex
  34.  
  35. ;<EOF>
  36.  
  37. ------------------------------------------------------------------------------
  38.  
  39. 2. Insert a CDROM disk into your drive and execute TESTDRV with the 
  40.    appropriate command line options:
  41.  
  42.     /# - (where # is number from 0-7) The drive unit number
  43.     /A - Attended Mode
  44.     /I - Ignore Control Disks
  45.     /T - Terse output (verbose is default)
  46.     [FILENAME] - Alternate Profile
  47.  
  48.    All output is through standard out and can be captured with any
  49.    redirection utility like TEE.COM
  50.  
  51. 3. If your driver survives, try the test using one of the following discs:
  52.  
  53.     Microsoft Programmer's Library v1.0 (c)1988
  54.     Microsoft Programmer's Library v1.1a (c)1989
  55.     Microsoft Small Business Consultant v1.0 (c)1988
  56.     Microsoft Bookshelf (c)1987
  57.  
  58.    The SECTOR MATCH test will attempt to verify the data from both
  59.    HSG addressed Cooked and Raw modes.  The location of sample archives
  60.    is assumed to be the current directory, but may be specified by setting
  61.    the TESTDRV environment variable to the correct directory path.
  62.  
  63. Question and answer time:
  64.  
  65. Q: What is the format of the output?
  66.  
  67. A:
  68.  
  69. <CODE>  <STATUS>    <COMMAND>:<COMMENT>
  70.  
  71. The <CODE> is the driver request.  Subcommands of IOCTLI and IOCTLO are
  72. separated by a period ".".  The <STATUS> is the state of the test or request
  73. this may be:
  74.   
  75.     *ERROR*  - High priority error, generated by the driver
  76.     -ERROR-  - Error, generated by this application
  77.     WARNING  - Unusual event, possibly hardware dependent
  78.     TESTING  - Announcement of a device request (verbose mode)
  79.  
  80. The <COMMAND> is the mnemonic for the driver request.  The <COMMENT> is
  81. any information the test might want to make known.
  82.  
  83.  
  84. Q: In "verbose mode" there are often trailing messages like ERROR 0x03,
  85.    BUSY, or DONE.  What do they mean?
  86.  
  87. A:
  88.  
  89. Each call to the driver should return a status word.  The status word may
  90. have any combination of ERROR, BUSY and DONE bits set.  If an ERROR is
  91. returned, it is accompanied by the lower byte of the status word and can
  92. be interpreted by looking at the driver spec.  Since the testing suite
  93. is trying to invoke errors, the error bit will be set for many requests, but
  94. the interpretation of an incorrect return value will the TESTING line.
  95.  
  96.  
  97. Q: The TESTDRV program freezes at call 3.128 and locks up my machine.
  98.    What does this mean?
  99.  
  100. A:
  101.  
  102. If the suite freezes, it is an indication of an incorrectly implemented
  103. driver function.  No driver function is non-returnable and most driver
  104. functions must return in error if a the function cannot be completed.
  105.  
  106. For example, if the test freezes at call 3.128 you should assume that there
  107. is something wrong with your driver's response to that call.  TESTDRV does
  108. nothing more than send correctly formatted requests to the driver through the
  109. INT 2Fh interface for MSCDEX and report on incorrect responses.
  110.  
  111. Q: The TESTDRV program freezes fairly early in the test and I would
  112.    like to evaluate more of the driver calls before I start debugging.
  113.    What can I do?
  114.  
  115. A:
  116.  
  117. By using the attended mode switch, you can skip tests that prove to be
  118. troublesome for your driver.  For example, many drivers do not properly 
  119. free the initialization code and forget to map the INIT call to UNKNOWN
  120. COMMAND.  A driver that does not drop the initialization code is probably
  121. not of optimal size.  The developer can use the HITACHI sources as a cue
  122. to implement this scheme.
  123.  
  124. In the attended mode there is the option to switch into non attended mode.
  125. To do this type 'c' at any attended mode prompt.
  126.  
  127. ------------------------------------------------------------------------------
  128.  
  129. This suite was used to test the released HITACHI.SYS driver.  Most late bug
  130. fixes made to this driver were as a result of failing a test in this suite.
  131. It is recommended that the developer use the HITACHI.SYS sources as a general
  132. template for adhereing to the spec.  Feel free to modify the testing code
  133. for internal testing.
  134.  
  135. - John Y. Geer
  136.   johnyg@microsoft.com
  137.  
  138. ------------------------------------------------------------------------------
  139.  
  140. Some more undocumented changes:
  141.  
  142. ATTENDED MODE CHOICES :
  143.  
  144.     At every prompt you will be given the choice "[Yncq]".
  145.     
  146.     Y or SPACE      executes the test
  147.     n               skips the test
  148.     c               switches to non-attended mode
  149.     q               quits
  150.  
  151.  
  152. Last Update:
  153. 9/21/90
  154.  
  155.